Spec-Zone.ru › C++

std::literals::string_literals::operator""s

Определено в заголовочном файле <string>
std::string operator""s( const char* str, std::size_t len );
(1) (начиная с C++14)
(constexpr начиная с C++20)
constexpr std::u8string operator""s( const char8_t* str,
                                     std::size_t len );
(2) (начиная с C++20)
std::u16string operator""s( const char16_t* str, std::size_t len );
(3) (начиная с C++14)
(constexpr начиная с C++20)
std::u32string operator""s( const char32_t* str, std::size_t len );
(4) (начиная с C++14)
(constexpr начиная с C++20)
std::wstring operator""s( const wchar_t* str, std::size_t len );
(5) (начиная с C++14)
(constexpr начиная с C++20)

Формирует строковый литерал требуемого типа.

1) Возвращает std::string{str, len}.
2) Возвращает std::u8string{str, len}.
3) Возвращает std::u16string{str, len}.
4) Возвращает std::u32string{str, len}.
5) Возвращает std::wstring{str, len}.

Параметры

str - указатель на начало литерала в виде массива символов без обработки
len - длина литерала в виде массива символов без обработки

Возвращаемое значение

Строковый литерал.

Примечания

Эти операторы объявлены в пространстве имён std::literals::string_literals, где и literals, и string_literals являются встроенными пространствами имён. Доступ к этим операторам можно получить с помощью любой из следующих директив using:

  • using namespace std::literals
  • using namespace std::string_literals
  • using namespace std::literals::string_literals

std::chrono::duration также определяет operator""s для представления литералов секунд, но это арифметический литерал: 10.0s и 10s — это десять секунд, а "10"s — строка.

Макрос проверки поддержки возможности Значение Стандарт Возможность
__cpp_lib_string_udls 201304L (C++14) Пользовательские литералы для строковых типов

Пример

#include <iostream>
#include <string>

void print_with_zeros(const auto note, const std::string& s)
{
    std::cout << note;
    for (const char c : s)
        c ? std::cout << c : std::cout << "₀";
    std::cout << " (size = " << s.size() << ")\n";
}

int main()
{
    using namespace std::string_literals;
    
    std::string s1 = "abc\0\0def";
    std::string s2 = "abc\0\0def"s;
    print_with_zeros("s1: ", s1);
    print_with_zeros("s2: ", s2);
    
    std::cout << "abcdef"s.substr(1,4) << '\n';
}

Вывод:

s1: abc (size = 3)
s2: abc₀₀def (size = 8)
bcde

См. также

(конструктор)
создаёт basic_string
(открытая функция-член)
operator""sv
(C++17)
создаёт строковое представление литерала в виде массива символов
(функция)

© cppreference.com
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
https://en.cppreference.com/cpp/string/basic_string/operator%22%22s

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API